home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d12
/
ntbiodoc.arc
/
NETBIOS.DOC
< prev
Wrap
Text File
|
1989-06-26
|
83KB
|
2,839 lines
## ## ####### ######## ###### #### ## ######
### ## ## ## ## ## ## ## ## ## ##
#### ## ## ## ## ## ## ## ## ##
## ## ## ##### ## ###### ## ## ## ######
## #### ## ## ## ## ## ## ## ##
## ### ## ## ## ## ## ## ## ## ##
## ## ####### ## ###### #### ## #####
CBIS Net Bios
Programmer's Reference
by Tom Thompson
April 1988
CBIS,Inc.
5875 Peachtree Industrial Blvd.
Bldg. 100 Suite 170
Norcross, GA 30092
Copyright (c) 1988 by CBIS, Inc. All rights reserved. No part
of this publication may be reproduced without the prior written
permission of CBIS, Inc., P.O. Box 921206, Norcross, GA 30092.
CBIS, Inc. makes no representations or warranties with respect to
the contents hereof and specifically disclaims any warranties
either expressed or implied of merchantability or fitness for any
particular purpose. CBIS, Inc. reserves the right to change this
publication and the software programs to which it relates with no
obligation to notify any person or organization of such changes.
ii
Abstract
Net BIOS is a software interface between computer programs and a
Local Area Network Adapter (LANA), or "LAN card". It is used in
Local Area Network (LAN) systems consisting of IBM compatible
microcomputers. The components of a LAN are the computers, each
containing a LAN card, the interconnect cables, and the Net BIOS
software. Net BIOS has been implemented for a variety of LAN
card types. These include Token Ring, Ethernet and ARCNET.
Application programs on different computers can communicate by
using Net BIOS services to send and receive messages.
The purpose of the Net BIOS is to isolate the application program
from the actual type of hardware used in the LAN. It also spares
the application programmer the details of network error recovery
and low level message addressing or routing.
In a Net BIOS implementation of a LAN, the computers on the
system are known by names. Each computer has a permanent name
that is programmed onto the LAN card. Computers on the system
can also be known by names designated by the programmer. The
commands available in Net BIOS include commands to add and delete
names.
Computers on a Net BIOS implementation of a LAN can communicate
either by establishing a session or by using datagram or
broadcast methods. Sessions allow a larger message to be sent
and handle error detection and recovery but they only allow
computers to communicate on a one-to-one basis. Datagram
and broadcast methods allow one computer to communicate with
several other computers at the same time, but are limited in
message size. Datagram and broadcast methods of communication do
no handle error detection and recovery. Net BIOS session control
commands and session data transfer commands allow communication
through sessions. Net BIOS datagram commands allow communication
without the use of sessions.
All commands are presented to the Net BIOS in a format called
Network Control Blocks (NCB). These blocks are allocated in
memory by the user program. The user program is also responsible
for setting the neccessary input fields of the NCB and
initializing the fields not used to zeros. Several fields in the
NCB are reserved for output from Net BIOS upon completion of a
command.
This manual discusses names and data communication methods in a
Net BIOS implementation of a LAN. Discussions of NCBs and Net
BIOS commands include descriptions of all the fields in an NCB and
all Net BIOS commands. Each Net BIOS command description lists
the NCB fields that are used for input or output for that
command. NCB and command information is summarized in the
Appendices at the end of the manual.
iii
TABLE OF CONTENTS
Introduction . . . . . . . . . . . . . . . . . . 1
Chapter 1
General Information . . . . . . . . . . . . 2
Net BIOS Names . . . . . . . . . . . . 2
Types of Data Transfer . . . . . . . . 3
Data Transfer Example . . . . . . . . 3
Calling Net BIOS . . . . . . . . . . . 3
Net BIOS Command Modes . . . . . . . . 4
Chapter 2
Communication with Net BIOS . . . . . . . . 5
Wait Mode . . . . . . . . . . . . . . 5
No-Wait Polling Mode . . . . . . . . . 5
No-Wait with Post Mode . . . . . . . . 6
Chapter 3
Network Control Block Format . . . . . . . 7
Assembly Language NCB Structure . . . . . . 9
Chapter 4
Net BIOS Commands . . . . . . . . . . . . . 10
General Commands . . . . . . . . . . . 11
Reset Command . . . . . . . . . . 11
Cancel Command . . . . . . . . . 12
Adapter Status Command . . . . . 13
Unlink Command . . . . . . . . . 16
Name Commands . . . . . . . . . . . . 17
Add Name Command . . . . . . . . 17
Add Group Name Command . . . . . 18
Delete Name Command . . . . . . . 19
Session Control Commands . . . . . . . 20
Call Command . . . . . . . . . . 20
Listen Command . . . . . . . . . 21
Hangup Command . . . . . . . . . 22
Session Status Command . . . . . 23
Session Data Transfer Command . . . . 25
Send Command . . . . . . . . . . 26
Chain Send Command . . . . . . . 27
Receive Command . . . . . . . . . 28
Receive Any Command . . . . . . . 29
Datagram Commands . . . . . . . . . . 30
Send Datagram Command . . . . . . 30
Receive Datagram Command . . . . 31
Send Broadcast Command . . . . . 32
Receive Broadcast Command . . . . 33
iv
TABLE OF CONTENTS (Cont.)
Appendix A
Net BIOS Command Summary . . . . . . . . . A-1
Appendix B
Net BIOS Control Block Format . . . . . . B-1
NCB Field Input/Output Summary . . . . . . B-2
Appendix C
Net BIOS Error Code Listing . . . . . . . C-1
List of Tables
1 - Adapter Status Result Buffer . . . . . . 14
2 - Session Status Result Buffer . . . . . . 24
v